home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 128 #35 / q35.d81 / magic docs < prev    next >
Encoding:
Text File  |  1992-01-01  |  39.8 KB  |  925 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                   
  7.                   Page          Table of Contents
  8.                   
  9.                   
  10.                   1             Getting Loaded
  11.                   1             The Launch...
  12.                   1             Set The Drive Number
  13.                   1             Getting Our Feet Wet
  14.                   2             The Status Line
  15.                   2             The Logo / User Interface Line
  16.                   3             HELP Me PLEASE!
  17.                   3             Navigation
  18.                   3             GRABbing Files
  19.                   4             Now That I GRABbed it, What Can I DO With It?
  20.                   4                Move It
  21.                   4                Swap It
  22.                   4                Rename It
  23.                   4                Change File Type
  24.                   4                Lock It
  25.                   5                Scratch It
  26.                   5                Unscratch It
  27.                   5                Oops!
  28.                   5                A Sorted Affair
  29.                   6                Moving Scratches    [ooh!]
  30.                   6                WunderBars
  31.                   8             Dont Forget To Write
  32.                   8             BAM!
  33.                   8             Partition Processing
  34.                   8             Conquering Divides
  35.                   10            DOS Operations
  36.                   11            Renaming a Disk
  37.                   12            Directory to Printer
  38.                   12            Disk Files to Printer
  39.                   12            And Finally...
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                                 Magic 128 V1.16
  70.                                                                 by e.g.bell    
  71.                   
  72.      ***          Getting Loaded
  73.      
  74.      
  75.      Magic 128 is a 1581 directory manipulator that also supports 1541 and
  76.      1571 format disks.  The program was written in machine language for
  77.      speed.  The name was inspired by a C64 mode program that I was always
  78.      so impressed with, called Directory Magic.  It was one of my very
  79.      favorite utilities for the C64.  I wanted something that did
  80.      everything Directory Magic did, and a lot more.  I think you'll find
  81.      Magic 128 every bit as useful, and maybe quite a bit more.  
  82.      
  83.      To get started, all you have to do is type
  84.      
  85.      Ex 1:        run "Magic 128*"
  86.                          or    
  87.      Ex 2:        run "Magic 128*",u#             Where #=Drive Number
  88.      
  89.      You can run Magic 128 from LOADSTAR by choosing Run It.
  90.      
  91.      The program will load and begin executing.  The first thing it does is
  92.      load a support file called  BURST SUBS.BIN+ from the same disk drive.
  93.      Make sure you have the two files on the same disk.  
  94.      
  95.      If you aren't using drive 8 for your source drive, make sure you use a
  96.      RUN statement like the second example above, specifying your drive
  97.      number after the U.  Magic 128 will load the support file from
  98.      whatever drive you start out with.  The BURST SUBS.BIN+ file is the
  99.      one included on the 1581 demo disk along with a little code I added
  100.      for Magic 128.  You MUST use my version to get the extra code Magic
  101.      128 needs.
  102.      
  103.      ***          The Launch...
  104.      
  105.      When the loading is all done, you will be facing a HELP screen of many
  106.      of the command options of Magic 128.  Press a key to get to the work
  107.      screen.  The work screen will be blank with a box pointer flashing in
  108.      the upper left corner of the work area.  The work screen is where you
  109.      will be able to execute the functions of Magic 128.  No commands work
  110.      while in the HELP mode.
  111.      
  112.      Insert a disk.  It is best to start with a backup disk first, until
  113.      you get comfortable with Magic 128.   
  114.      
  115.      ***          Set The Drive Number
  116.      
  117.      The drive you load Magic 128 from is the drive that will be used for
  118.      subsequent Magic operations.  You can change this if you like, by
  119.      pressing CTRL-d from the work screen.  This will allow you to specify
  120.      what drive you would like to use.  The acceptable range is from 8 to
  121.      30.  In this regard, if you use the Xetec Super Gold Interface for
  122.      your printer, don't use device 14 for your drive.  This is a reserved
  123.      device number used with a burst driver for that interface.
  124.      
  125.      ***          Getting Our Feet Wet
  126.      
  127.      Press r to read the disk, and the screen will blank.  When it comes
  128.      back, you will be looking at a screen formatted in up to 4 columns
  129.      containing the filenames from the directory of the disk you have just
  130.  
  131.                                       Page 1
  132.  
  133.  
  134.  
  135.                                                             Magic 128 V1.16
  136.                                                             by e.g.bell    
  137.      
  138.      read.  There are up to 20 files in a column, meaning up to 80
  139.      filenames can be displayed on a screen.
  140.      
  141.      To the right of each filename is a : character followed by the first
  142.      letter of the filetype of that directory entry.  Splat files will show
  143.      a * in this position.  Locked files will show a < just before the
  144.      colon.  This is a lot of information in a little space, but you'll get
  145.      used to it.   Operation speed dictated doing things like this.
  146.      Attributes (reverse, color, flashing, etc.) are not available in the
  147.      main work screen.
  148.      
  149.      If there are more than 80 files on the disk, there will be 1 or more
  150.      additional pages of the same format, up to 4 pages total.  Magic 128
  151.      will accomodate a full 1581 directory of up to 296 files, as well as
  152.      handling 1541 and 1571 diskettes.  Note!  The pages are all in VDC
  153.      memory at the same time, which means pages don't have to be repainted
  154.      each time.  Everything is quick...a twiddled bit's distance from one
  155.      page to the next.
  156.      
  157.      ***          The Status Line
  158.      
  159.      The two lines at the bottom of every Magic 128 screen are
  160.      informational lines. They tell you the status of the disk directory
  161.      and the file in the GRAB buffer. If you have not GRABbed a file, this
  162.      line will only display information about the disk you have in the
  163.      drive [you must Read the disk by pressing r first]  If you have
  164.      GRABbed a file, then the filename will be displayed, along with its
  165.      locked/unlocked status, file type, starting track and sector, and size
  166.      in disk blocks.
  167.      
  168.      The MODE header on this informational line tells you what mode you are
  169.      in.  If you have a file GRABbed, the MODE is DUMP, meaning that you
  170.      cannot GRAB another file.  If no file is GRABbed, the MODE is GRAB,
  171.      meaning you can pick up a file.
  172.      
  173.      The FREE and USED columns tell you how many blocks on the disk are
  174.      used and how many are available.  The FILES column tells you how many
  175.      active files are on the disk, and DEL tells you how many deleted files
  176.      there are.  
  177.      
  178.      The DVC column tells you what drive is in use, either 41 (1541), 71
  179.      (1571), or 81 (1581).  It could also say ?, which means the drive is
  180.      not recognized.  The information is determined using a drive reset and
  181.      then reading the standard DOS error message returned.  This
  182.      information is pulled in at startup, and several times during
  183.      execution of Magic 128.  You can force such an inquiry by pressing
  184.      CTRL-w.  
  185.      
  186.      Note!  I said this is done using a drive reset.  This means that if
  187.      you use software or a  DOS command to set your device number, you are
  188.      going to have a problem with this program.  To use it, switch all of
  189.      your other drives off, and just use drive 8.  This should only even be
  190.      a concern to 1541 users or 128D users with no switches on their
  191.      drives.
  192.      
  193.      ***          The Logo / User Interface Line
  194.  
  195.                                       Page 2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                             Magic 128 V1.16
  202.                                                             by e.g.bell    
  203.      
  204.      
  205.      The user interface line, where Magic 128 gets most keyboard input from
  206.      you, is the top screen line.  This is also where you are informed
  207.      about what is happening.  Magic is very informative about what it is
  208.      doing at all times.
  209.      
  210.      ***          HELP Me PLEASE!
  211.      
  212.      Magic 128 is a very friendly program.  If you need HELP at any time,
  213.      press the HELP key.  [You can also press ?,  CTRL-H,  H,  or  SHIFT-
  214.      RUN/STOP].  This will bring up a HELP screen.  There are currently 8
  215.      HELP screens, numbered 5.0 through 5.7, resident at all times.  To
  216.      advance to the next one, just press HELP again, or SHIFT-RUN/STOP. If
  217.      you like, you can also go directly to a specific HELP screen.  They
  218.      are numbered 0 through 7.  To go to a specific screen, just press the
  219.      corresponding digit.  For example, to go directly to screen 5.7, just
  220.      press '7'.  This ONLY works when you are in HELP mode.  The screen
  221.      will blank while the next HELP screen is being painted.  When you have
  222.      the HELP you need, press any other key to return to the Magic work
  223.      screen.  The last HELP screen displayed when you exit HELP mode will
  224.      be the one you see the next time you request HELP. 
  225.      
  226.      Virtually every command available in Magic 128 is listed at least once
  227.      in one of the HELP screens.  Some functions are available with more
  228.      than one key.  For instance,  you can GRAB a file by pressing g or F1.
  229.      You can DUMP a file by pressing d or F3.  There are several commands
  230.      with more than one key like that.
  231.      
  232.      ***          Navigation
  233.      
  234.      Since you may have up to 4 pages of directory entries, if you want to
  235.      GRAB a file on a page other than the current one, use the + and -
  236.      keys, or CTRL-f, to move forward and backward through the available
  237.      pages.
  238.      
  239.      You can use the HOME key to move to the first directory entry on the
  240.      current page, or SHIFT-CLR/HOME to move to the first file on the first
  241.      page.  [F5/F6 perform the same functions].  
  242.      
  243.      You can use the BACK ARROW to move the pointer to the last file on the
  244.      current page, or the ^ key to move to the last file on the last page.
  245.      [F7/F8 perform the same functions.]
  246.      
  247.      
  248.      ***          GRABbing Files
  249.      
  250.      Now, the only thing you need to know to get started is that, for most
  251.      of the features in Magic 128, you must GRAB a file first, using g or
  252.      F1 from the work screen. Then you can move it, rename it, change
  253.      types, kill it, unscratch it, etc.  There are exceptions, of course,
  254.      like sorts, but most of the operations that operate on individual file
  255.      entries require that you GRAB that file.  
  256.      
  257.      When you have GRABbed a file, it will appear on the status line and
  258.      Mode will switch from GRAB to DUMP.  If you attempt an operation that
  259.      requires a GRABbed file and you don't have one, you will be notified
  260.  
  261.                                       Page 3
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                                                             Magic 128 V1.16
  268.                                                             by e.g.bell    
  269.      
  270.      by a message on the top screen line.  The operation you requested will
  271.      not be allowed until you GRAB a file.
  272.      
  273.      GRABbing and DUMPing files are the most basic functions of Magic 128.
  274.      To GRAB a file, simply move the little green box pointer beside the
  275.      file you want to GRAB using the up/down/right/left pointer keys.  When
  276.      the pointer is set, just press  g or F1 and that file will be GRABbed.
  277.      Note!  If you have already GRABbed a file and you want to pick up a
  278.      different one, you must either 1] dump the file you have, or 2] zap
  279.      the GRAB buffer.  Ill cover this shortly.
  280.      
  281.      ***          Now That I GRABbed it, What Can I DO With It?
  282.      
  283.      What can I do with a file once I GRAB it?
  284.      
  285.      ***          Move It
  286.      
  287.      You can move it to another position in the directory.  Just move the
  288.      pointer, the same way you did to GRAB a file.  Position it where you
  289.      want the GRABbed file to be inserted and press d or F3.  It will be
  290.      inserted BEFORE the entry the pointer is beside.  For this reason, you
  291.      can't DUMP it into the last slot in the directory with this function.
  292.      For that, see SWAP IT, immediately below.  [See also
  293.      BLOCK OPERATIONS]
  294.      
  295.      ***          Swap It
  296.      
  297.      You can swap it with a different file.  Move the pointer to the one
  298.      you want to swap, and press CTRL-s.  The GRABbed file will be inserted
  299.      at this point, and the file at this point will be inserted where the
  300.      GRABbed file was.  Use this to move a file to the last position in a
  301.      directory.  Just GRAB the last file, move the pointer to the next to
  302.      the last file, and press CTRL-s.  Neat!
  303.      
  304.      ***          Rename It
  305.      
  306.      You can rename it.  Just press CTRL-r, then enter the new name.   This
  307.      change only occurs to the GRAB buffer.  If you are satisfied, when the
  308.      name in the status line at the bottom is correct, press i or ctrl-m to
  309.      implement the change.
  310.      
  311.      ***          Change File Type
  312.      
  313.      Press CTRL-c if you want to change file types.  Again, this change is
  314.      to the GRAB buffer only.  If you are satisfied with it, just press i
  315.      or CTRL-m.  If you want to change all files of a specific type in a
  316.      directory to another type, for example, change all SEQ files to PRG
  317.      files, press CTRL-t.  You will be asked for the from/to parameters.
  318.      If you pick the same type for both, nothing will be done.  Any valid
  319.      choice will be processed immediately.  [See also BLOCK OPERATIONS]
  320.      
  321.      ***          Lock It
  322.      
  323.      Press CTRL-l if you want to lock the file, then i or CTRL-m to
  324.      implement the change.  This will prevent the file from being
  325.      accidentally scratched.  Locked files are identified by the <
  326.  
  327.                                       Page 4
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                                             Magic 128 V1.16
  334.                                                             by e.g.bell    
  335.      
  336.      character somewhere in the directory display after the filename.  [See
  337.      also BLOCK OPERATIONS]
  338.      
  339.      ***          Unlock It
  340.      
  341.      Press CTRL-u to unlock a locked file, then i or CTRL-m to implement
  342.      the change.  Unlocking a file reverses the LOCK status, opening the
  343.      file to be scratched, opened for writes, etc.  [See also BLOCK
  344.      OPERATIONS]
  345.      
  346.      ***          Scratch It
  347.      
  348.      Press the INST/DEL key to delete the GRABbed file, and then i or CTRL-
  349.      m to implement the change.  Use this feature to batch scratch a bunch
  350.      of files quickly.  The changes will only be effective when you write
  351.      the directory back to disk. It does save time.  [See also BLOCK
  352.      OPERATIONS]
  353.      
  354.      ***          Unscratch It
  355.      
  356.      Press SHIFT-INST/DEL if the GRABbed file is a scratched file and you
  357.      want to unscratch it.  Checks will be made to assure the file hasn't
  358.      been overwritten, and then it will automatically be restored.  The
  359.      last step in the unscratch process requires you to enter the file type
  360.      of this file.
  361.      
  362.                          -> NOTE <- 
  363.      
  364.      When you scratch or unscratch files as described above, the disk is
  365.      automatically flagged for validation after a write of the directory.
  366.      This is necessary to update the BAM concerning your changes.  ** Moral
  367.      of the story **   I don't know if Magic 128 will work on a GEOS disk.
  368.      If you try, DON'T scratch any files.
  369.      
  370.      Pssst! A 1541 CAN'T unscratch files on the back of double-sided
  371.      disks!
  372.      You should NOT use Magic 128 on a GEOS disk!
  373.      
  374.      ***          Oops!
  375.      
  376.      Most Magic file operations work like this, changing the GRABbed file
  377.      only.  If you GRAB the wrong file or change your mind about the
  378.      change, press z to zap the GRABbed buffer.  This is an Ooops function
  379.      affecting only the GRAB buffer.  This doesn't hurt the original entry
  380.      in the directory buffer.  It only clears out the GRAB buffer.
  381.      
  382.      If, after you have made a lot of changes, you decide you want to start
  383.      over, you can read the directory again or just press CTRL-o, which is
  384.      an Ooops! function.  It will restore the directory as it appeared when
  385.      you first read the disk.
  386.      
  387.      If you try to perform an operation that needs a file, and you haven't
  388.      GRABbed one, you will be notified.  No harm done!
  389.      
  390.      ***          A Sorted Affair
  391.      
  392.  
  393.                                       Page 5
  394.  
  395.  
  396.  
  397.  
  398.  
  399.                                                             Magic 128 V1.16
  400.                                                             by e.g.bell    
  401.      
  402.      You can sort files on the disk by either filename or filetype.  Since
  403.      this is done at machine language speed, it is very quick.  Choosing a
  404.      sort by filename, by pressing CTRL-n or n, involves no more input from
  405.      you.  It is simply done.  VERY QUICKLY!  If you choose to sort by
  406.      filetype, by pressing t, you will also be able to specify the order in
  407.      which you want the types to appear.  Just follow the onscreen
  408.      instructions.   You simply have to enter a string of numbers from 0 to
  409.      5 which correspond to the different file types.  The sort will then
  410.      use this string to determine the sort order for the respective file
  411.      types. [See also BLOCK OPERATIONS]
  412.      
  413.      ***          Moving Scratches   [ooh!]
  414.      
  415.      You can bump the scratched files to the top of the directory or the
  416.      bottom of the directory.  You might want them at the top to make sure
  417.      the next file/s saved will be in the first positions of the directory.
  418.      When you bump them to the bottom of the directory, you will also be
  419.      offered the opportunity to snip them from the directory.  This is a
  420.      great feature to clean your disks of old, long deleted files.  
  421.      
  422.      ** NOTE **  If you snip scratched files from your disks, you will have
  423.      an extremely hard time if you ever have to recover them.  Still, it is
  424.      a very useful feature if you decide to use it.
  425.      
  426.      ***          WunderBars
  427.      
  428.      A very nice feature of Magic 128 allows you to insert separator bars
  429.      at points where you choose.  These appear as 16 shift-* characters.
  430.      In other words, a bar, but the bar filenames will each be unique so
  431.      that file copiers will not burp on them.  You can have more variations
  432.      of such bars than you can have files on a disk.  In this regard, when
  433.      created, these BARS point to a single directory block on the disk.
  434.      When copied, most copiers will probably create a unique file for each
  435.      one.  You may want to take this into consideration if you have a lot
  436.      of bars on a disk with very little room left.
  437.      
  438.      Magic 128 will make sure there are no duplicate separators on the
  439.      disk.  When you GRAB one, you will see sections of pink and red in the
  440.      filename characters.  (All other filenames in the status line are
  441.      white)  These colors graphically display how the filenames are
  442.      different.  
  443.      
  444.      Separator bars show up as using 1 block in the directory.  Their
  445.      track/sector will always be track 18 sector 18 on 1541/71 diskettes
  446.      and track 40 sector 2 on 1581 diskettes.  This was just to make sure
  447.      they cause no bam problems.  If you delete them, you will deallocate
  448.      nothing.  Note!  This also requires that some editing of the 1541/71
  449.      sector be done, writing a chr$(255) into the second byte to make it
  450.      look like the last sector in a file.  Again, this will be totally
  451.      transparent to you in any situation.
  452.      
  453.      If you ever want to get rid of all such files on a disk, use the k
  454.      function. You will have to verify this selection, but it will scratch
  455.      all the bars from the disk.  You can then read the directory, if you
  456.      want, bump the DEL files to the bottom of the directory, and snip them
  457.      right off the disk.
  458.  
  459.                                       Page 6
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                                                             Magic 128 V1.16
  466.                                                             by e.g.bell    
  467.      
  468.      
  469.      ***          Block Operations
  470.      
  471.      Occasionally, you will want to perform an operation on a group of
  472.      files instead of the whole buffer.  For example, when you have saved a
  473.      new group of files that are at the end of a large directory, and you
  474.      want to move them to the top, doing this one file at a time is
  475.      extremely tedious.  Perhaps you have a directory in which you want to
  476.      sort just a particular set of files on a disk by name or type. (The
  477.      TXT files in the CS-DOS archives would be a good example.)  Magic 128
  478.      gives you the ability to sort (by name or type), kill, lock, or unlock
  479.      the whole buffer or groups of files in the buffer.
  480.      
  481.      To perform any of these functions on a block of files, first GRAB a
  482.      file normally.  Then move the pointer to the file entry at the end of
  483.      the desired range of files and press CMDR-<letter>, where <letter> is
  484.      a letter from the menu displayed below.  If your entries are valid,
  485.      the operation will be performed on the specified range.  You will see
  486.      the start and end files in the range displayed on the status line at
  487.      the bottom of the screen.  For sorts, lock/unlocks, and deletions, the
  488.      operation requires no more of you.  After a very brief pause, your
  489.      instructions are implemented.
  490.      
  491.      To move blocks of files, simply point to the first file, as before,
  492.      and press g or F1 to GRAB the file.  So far, nothing is different.
  493.      Now, move the pointer to the second file, the end of the desired
  494.      range, and press CMDR-G.  Finally, move the pointer to the position at
  495.      which you want the range inserted and press 'd'.  If valid, the whole
  496.      block will be moved.  
  497.      
  498.      For these block type operations, it doesn't matter in which order you
  499.      GRAB the start and end files.  They will be corrected before
  500.      execution.  *Note!*  For block moves, you will not be allowed to
  501.      insert the block into itself or at the same position either.  But
  502.      then, why would you?  The options are as follows:
  503.      
  504.      
  505.      The Currently Available BLOCK Commands
  506.      --------------------------------------
  507.      
  508.      CMDR    G   Grab Second File in Block Move
  509.                    - Set Pointer and press 'g' to GRAB 1st file
  510.                    - Set Pointer and press CMDR-'g' to grab 2nd file
  511.                    - Set Pointer to destination and press 'd' to DUMP
  512.      
  513.               K   Kill (Scratch) All Files In Block/Buffer.  BE CAREFUL!
  514.               L   Lock All Files In Block/Buffer
  515.               N   Sort All Files In Block/Buffer By Name
  516.               T   Sort All Files In Block/Buffer By File Type
  517.               U   Unlock All Files In Block/Buffer
  518.      
  519.      
  520.      
  521.      For selections other than CMDR-g, simply move the pointer to the first
  522.      file and press g to GRAB it.  Then move the pointer to the second file
  523.      and press  CMDR-<key>.  To act on the whole buffer, just press the
  524.  
  525.                                       Page 7
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                                             Magic 128 V1.16
  532.                                                             by e.g.bell    
  533.      
  534.      correct key combination with NO FILES GRABBED.  
  535.      
  536.      ** NOTE **  All of these functions EXCEPT CMDR-K can be undone easily.
  537.      The only way to undo a CMDR-K, if you write it to disk, is to read it
  538.      back in and unscratch each program.  Magic 128 can do it, but a little
  539.      caution can make it unnecessary.  (If you change your mind before
  540.      writing the directory back to disk, just press CTRL-o, the BIG OOPS! 
  541.      
  542.      ***          Dont Forget To Write
  543.      
  544.      When you have made all desired changes, press w to write the directory
  545.      back to disk.  You must verify this selection.  If you do, the
  546.      directory you created/edited will be written to the disk.  The
  547.      information will be wiped from memory to prevent being written to
  548.      another disk.  Remember!  Most of the editing functions in Magic 128
  549.      are done only in memory, and are not valid unless you write them to
  550.      disk by pressing w.
  551.      
  552.       You CANNOT    write a directory if you haven't READ a directory!
  553.       You SHOULDN'T write a directory to a disk you didn't read!
  554.      
  555.      *Note*  If you have scratched or unscratched any files, the disk will
  556.      automatically be validated after the edited directory is written.
  557.      
  558.      ***          BAM!
  559.      
  560.      You can see the Block Allocation Map if you press CTRL-a after reading
  561.      a disk.  This allows you to see what sectors are used on each track.
  562.      For the 1581, you might find this very useful if you want to create
  563.      partitions on previously used disks.  Magic 128 doesn't make
  564.      partitions in this version.  Well see what the future holds.
  565.      
  566.       You CANNOT see a BAM map of a directory you haven't READ!
  567.      
  568.      ***          Partition Processing
  569.      
  570.      All of the operations available in Magic 128 can be used in
  571.      partitions.  Magic 128 doesn't atually have to go into a partition.
  572.      To edit the directory of a partion, you must GRAB a CBM type file from
  573.      the directory.  Then you can read it.  When you do this, a P will
  574.      flash beside the 81 on the status line at the bottom of the screen.
  575.      Magic 128 sees partitions simply as another directory.  All writes are
  576.      done to tracks and sectors, and not to directories per se.  Thus
  577.      partitions are seen like any other directory, and can be edited at
  578.      will.
  579.      
  580.      ***          Conquering Divides
  581.      
  582.      You can also create partitions using Magic 128.  This should prove to
  583.      be one of the easier utilities available for this operation, because
  584.      you have quick access to the BAM, telling you what areas of the disk
  585.      are available.  Magic 128 creates partitions only in the format
  586.      acceptable for sub-directories.  Basically, this means they start on
  587.      sector 0 of the first track in the partition and the included sectors
  588.      are an even multiple of 40.  This makes things very simple for you.
  589.      Think in terms of tracks.  Partitions will include only empty tracks.
  590.  
  591.                                       Page 8
  592.  
  593.  
  594.  
  595.  
  596.  
  597.                                                             Magic 128 V1.16
  598.                                                             by e.g.bell    
  599.      
  600.      The procedure to create one is very simple.
  601.      
  602.      You should have some idea of how many sectors you want for your
  603.      partition.  REMEMBER!  This number must be evenly divisible by 40.
  604.      Divide your number by 40 and add 1 (to account for the directory you
  605.      will be creating) and that is how many consecutive empty tracks you
  606.      will need.  For instance, if you want 320 sectors in your partition,
  607.      you would divide that by 40, giving 8 tracks for your partition.  You
  608.      would add 1 for the partition directory, giving 9 tracks total for a
  609.      320 block partition.  Now you will need to find out where there is a
  610.      space on your disk 9 consecutive empty tracks long for your partition.
  611.      
  612.      
  613.      Insert the disk into your 1581 and press r to read it.  It will be
  614.      read whether there are any files on the disk or not.  Now, press CTRL-
  615.      a to display the BAM map for this disk.  You will see a display line
  616.      for the tracks which maps the sectors.  The display starts out on
  617.      track 40, the directory track.  (Use the + and - keys to scroll
  618.      forward and backward through the track displays)  Unused sectors are
  619.      displayed as white 'o' characters and used sectors are displayed as
  620.      pink '*' characters.  An empty track will appear as a row of 40 white
  621.      'o' characters.  If there are any pink '*' characters on a display
  622.      line, that many sectors are being used on this track and it is thus
  623.      unavailable for use in a partition.  For our example above of a 320
  624.      block partition, we must find 9 consecutive empty tracks.  These must
  625.      not include track 40, but track 40 will never be empty anyway, since
  626.      it is the main disk directory track.  All 9 tracks must either be
  627.      lower than track 40 (1-39) or higher than 40 (41-80).
  628.      
  629.      Let us say, for our example, that you find 9 consecutive empty tracks
  630.      starting at track 41.  (If you are starting this demo out with a
  631.      blank, formatted disk, this is a good place to start)  That means
  632.      tracks 41 through 49 have NO PINK '*' characters in the displays.  Now
  633.      we have all the information we need to create our partition.  From the
  634.      BAM screen, just press <RETURN> to exit to the main work screen.  At
  635.      the main work screen, press CMDR-p to begin creating your partition.
  636.       
  637.      First, you will be asked for a name for your partition.  This is the
  638.      name of the file that will show up on your directory as type CBM.
  639.      Name it following the same guidelines you would for any filename.  For
  640.      our demonstration, let's call it 'Partition Demo'.  Type that at the
  641.      prompt and press <RETURN>.
  642.      
  643.      Next, you will be asked for the starting track of the partition.
  644.      Enter the number we found earlier, track 41.  Finally, you will be
  645.      asked for the number of sectors in your partition.  You wanted 320
  646.      available sectors, so enter that.  At this point, don't concern
  647.      yourself with the 40 sectors for the directory.  Magic 128 will take
  648.      care of it.  You did all you had to do when you found the 9
  649.      consecutive tracks. 
  650.      
  651.      Now, and also during entry of this data, the information will be
  652.      checked for validity.  If it is invalid, you will be notified, and
  653.      will have to start over again.  Magic will make sure that what you
  654.      chose is valid.  If you have followed the steps outlined so far, there
  655.      should be no problem.
  656.  
  657.                                       Page 9
  658.  
  659.  
  660.  
  661.  
  662.  
  663.                                                             Magic 128 V1.16
  664.                                                             by e.g.bell    
  665.      
  666.      
  667.      After all of this is done, and checked, the partition will be created
  668.      on the disk.  There is now only one step needed before we can use it.
  669.      We must format it.  BE CAREFUL HERE!  Press 9 to request a directory.
  670.      Just press <RETURN> when asked for a pattern.  You will see the files
  671.      on the disk, including the newly created partition.  Now we must
  672.      'enter' that partition so we can format it. 
  673.      
  674.      From the work screen, press the @ key so that you can enter a
  675.      DOS command.  When the cursor is on the top screen line, enter the
  676.      command:
  677.       
  678.                  /0:Partition Demo
  679.       
  680.      You should see a message at the top of the screen saying something
  681.      like:
  682.       
  683.                  02, selected partition, 41,49
  684.       
  685.      You can consult your 1581 User's Guide (page 78) for the description
  686.      of the information on this line.  The important thing is, we are where
  687.      we must be now.  If you don't see a message like this, stop and try
  688.      the '/0:...' command again.  
  689.      
  690.      There is one other test we will try to make SURE we are in the
  691.      partition and not in the main directory of our disk.  Press 9 to ask
  692.      for a directory, and press <RETURN> when asked for a pattern.  You
  693.      should NOT see ANY FILES or ANY DISK NAME display.  You should only
  694.      see the flashing prompt at the top of the screen telling you to press
  695.      a key to continue.  If you see this, you can continue.  
  696.       
  697.      Press @ to enter DOS commands, and when the cursor is on the top
  698.      screen line, enter the following FORMAT command:
  699.       
  700.               n0:Demo,p1
  701.       
  702.      and press <RETURN>.  This will cause a 'long format' of the partition.
  703.      When done, you can check the directory, and you will see you have a
  704.      partition directory named 'Demo' that has 320 blocks available.  To
  705.      return to the main directory, just press the @ key again, and enter i
  706.      to 'initialize' the drive.  A directory now should show you the main
  707.      disk directory.  Try this on a few disks.  I think you'll find it very
  708.      quick, and a world easier than the 'partition.aid' program on the 1581
  709.      demo disk.
  710.      
  711.      ***                DOS Operations
  712.      
  713.      You can enter DOS commands in one of several ways from Magic 128.  If
  714.      you press @, 0 or CTRL-g, the box pointer will appear on the user
  715.      interface line at the top of the screen.  Just enter any valid DOS
  716.      command.
  717.      
  718.        Valid DOS Commands
  719.        {CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}{CBM-Y}
  720.            @  or  @:  or  @0:          Read Error Channel
  721.            i  or  i:  or  i0:          Initialize Drive
  722.  
  723.                                      Page 10
  724.  
  725.  
  726.  
  727.  
  728.  
  729.                                                             Magic 128 V1.16
  730.                                                             by e.g.bell    
  731.      
  732.            u  or  u;  or  u9           Reset Drive
  733.            v  or  v:  or  v0:          Validate Diskette
  734.      
  735.           s0:file1 [,file2,...]        Scratch specified files from Disk
  736.      
  737.           r0:newname=oldname           Rename oldname to newname
  738.      
  739.           c0:filex=file1 [,file2,...]  Make copy of file1 called filex
  740.                                        - or Concatenate file1 and file2
  741.                                          etc. into filex.  [Must be SEQ]
  742.           n0:disk name                 Short Format
  743.           n0:disk name,id              Long Format
  744.      
  745.      
  746.      The number keys 1-9 have been predefined to perform certain common DOS
  747.      functions also. 
  748.      
  749.           1  Initialize Drive                  6  Rename [On Disk]
  750.           2  Identify Drive                    7  Copy [Same Drive]
  751.           3  Reset Drive                       8  Format Disk
  752.           4  Validate Disk                     9  Disk Directory
  753.           5  Scratch [From Disk]               0  DOS Command
  754.      
  755.      For example, press 1 to initialize the drive, or 4 to validate the
  756.      disk.   Press 5 to scratch the GRABbed file.   Press 6 to rename the
  757.      GRABbed file.  These options all are performed ON THE DISK, not in
  758.      memory, so use caution.  
  759.      
  760.      If you press 9, you can get a display of the directory from the drive.
  761.      To get a full directory, just press RETURN when asked for a pattern.
  762.      Otherwise, enter the pattern after Pattern :$ on the user interface
  763.      line.  Wildcards are allowed.  Directories are done in 2 columns per
  764.      page of display.  To terminate the listing just press the STOP key,
  765.      then any key to exit to the main Magic 128 screen.
  766.      
  767.      Some of the DOS options are also available from the Magic work screen.
  768.      
  769.       For example:  CTRL-j      Reset Drive
  770.                     CTRL-i      Initialize Drive
  771.                     CTRL-v      Validate Disk
  772.      
  773.      ***          Renaming a Disk
  774.      
  775.      One other DOS type option you have is renaming the diskette.  You
  776.      never actually see the disk name in Magic, except when you display the
  777.      directory by pressing 9.  However, if you press CTRL-x, you will be
  778.      asked for a new disk name.  Enter what you want.  The change is *not*
  779.      made, however, until you write the directory to disk.
  780.      
  781.       You CANNOT rename a disk whose directory you haven't read!
  782.      
  783.      
  784.      ***          Set Printer Device Number
  785.      
  786.      Magic 128 supports some printer functions.  For instance, you can get
  787.      a DUMP of directory specifics.  You can also get a DUMP of SEQuential
  788.  
  789.                                      Page 11
  790.  
  791.  
  792.  
  793.  
  794.  
  795.                                                             Magic 128 V1.16
  796.                                                             by e.g.bell    
  797.      
  798.      or BASIC program files.  The default printer number is 4, which you
  799.      should never have to change, but if you need to change it to 5, the
  800.      only other allowable setting, press CTRL-p, and enter that.  You can
  801.      change this setting at any time you want.
  802.      
  803.      ***          Directory to Printer
  804.      
  805.      You can get a detailed printer DUMP of the directory in memory if you
  806.      press CTRL-q.  The output is in the same basic format as that of the
  807.      status line at the bottom of the screen.
  808.      
  809.      ***          Disk Files to Printer
  810.      
  811.      There are file readers in Magic 128 that allow you to DUMP sequential
  812.      or BASIC files to disk or printer.  Simply GRAB the file you want to
  813.      examine, then press CTRL-e.  You will have to make a couple of
  814.      decisions then.... screen or printer,  BASIC/True/Screen/Pet ASCII...
  815.      
  816.      
  817.      Magic 128 does the DUMPs from BANK 1 RAM.   The size allowed is just
  818.      under 63K, or about 250 disk blocks.  When you make all your
  819.      specifications, the file will be loaded into bank 1, then DUMPed from
  820.      RAM to wherever you requested.  If to the screen, youll get a page at
  821.      a time, and press a key to advance each page. Printer output is
  822.      continuous.  
  823.      
  824.      In either case, to quit before the display is complete, just press
  825.      STOP.  If you view the file all the way through, you have the option
  826.      to process the file again, starting at the top of all the options.
  827.      However, it will not have to be reloaded.  This just makes things a
  828.      little quicker.
  829.      
  830.      *Note!*  You cannot read CBM, REL, or DEL type files.
  831.      
  832.      ***          And Finally...
  833.      
  834.      There are some protections in Magic 128, and some conveniences.  For
  835.      instance, as noted above, you must verify certain operations like
  836.      writes to make sure you really meant to press those keys.  If you
  837.      change your mind after a lot of changes and/or want to start over
  838.      again, you may press CTRL-o, for Ooops! and the original directory
  839.      will be restored.
  840.      
  841.      Magic 128 will protect a boot sector if there is one on the disk.  It
  842.      preserves the correct BAM bit setting, and if necessary, reallocates
  843.      it following a VALIDATE command.
  844.                                                     
  845.      From the main Magic 128 screen, you can always exit to BASIC by
  846.      pressing the ESC key, x, or CTRL-x.
  847.      
  848.      There are many features and functions in Magic 128 that I didn't
  849.      cover, or didn't cover as thoroughly.  However, the program is menu
  850.      driven, and HELP is a keypress away.  You have enough to use the
  851.      program.  Hope you like it!  egb.
  852.      
  853.  
  854.  
  855.                                      Page 12
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                                                             Magic 128 V1.16
  862.                                                             by e.g.bell    
  863.      
  864.                   
  865.                   
  866.                   
  867.                   Topic                           Page
  868.                   
  869.                   Block Allocation Map .......... 8
  870.                   Block Commands ................ 7
  871.                   Block Operations .............. 4,6
  872.                   Boot Sector ................... 12
  873.                   BURST SUBS.BIN ................ 1
  874.                   Change File Type .............. 4
  875.                   Device Number ................. 1,2
  876.                   DOS Commands .................. 10
  877.                   Drive Number .................. 1
  878.                   Drive Reset ................... 2
  879.                   GEOS .......................... 5
  880.                   Lock .......................... 2,4-10,12
  881.                   Move .......................... 3,4,7
  882.                   Oops .......................... 5,8,12
  883.                   Partition ..................... 8-10
  884.                   Printer ....................... 1,12
  885.                   Rename A Disk ................. 11
  886.                   Rename ........................ 3,4,11
  887.                   Scratch ....................... 3-8,11
  888.                   Separator Bars ................ 6
  889.                   Sort Files .................... 5
  890.                   Splat Files ................... 1
  891.                   Status Line ................... 3,4,6-8,12
  892.                   Swap .......................... 4
  893.                   Unlock ........................ 2,5,7
  894.                   Unscratch ..................... 3,5,8
  895.                   User Interface Line ........... 2
  896.                   Validation .................... 5
  897.                   Work Screen ................... 1,2,3,9-11
  898.                    
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                              Page 13
  921.  
  922.  
  923.  
  924.  
  925.